# 날짜/시간 API

## 개요

날짜/시간(Date-Time API)는 소프웨어 개발 날짜와 시간을 효과적으로 표현, 조작, 계산, 형식화, 변하기 위한 표준 라이브러리의환으로, 프로그밍 언어나 플랫폼에 내장되어 제공되는 기능합입니다. 현대의 대부분 프로그래밍 언어는 복잡한 시간 계산, 타임존 처리, 일광 절약 시간(DST), 날짜 포맷팅 등의 요구를 충족하기 위해 강력하고 직관적인 날짜/시간 API를 제공하고 있습니다. 이 문서는 주로 자바의 `java.time` 패키지, Python의 `datetime` 모듈, JavaScript의 `Temporal` 제안 등 주요 언어의 날짜/시간 API를 중심으로 설명하며, 그 설계 철학과 실용적 사용법을 다룹니다.

---

## 주요 목적과 필요성

날짜와 시간은 애플리케이션에서 매우 흔히 다뤄지는 데이터 타입이지만, 그 처리는 의외로 복잡합니다. 예를 들어:

- **타임존(Timezone)**: 세계 각지의 시간대 차이
- **일광 절약 시간(Daylight Saving Time)**: 특정 기간 동안 시간이 1시간 앞당겨지는 현상
- **윤년, 월의 일수 차이**: 2월은 28일 또는 29일
- **서식(format)의 다양성**: `YYYY-MM-DD`, `MM/DD/YYYY`, `DD.MM.YYYY` 등

이러한 복잡성을 개발자가 직접 처리하는 것은 오류를 유발하기 쉬우며 유지보수도 어려워집니다. 따라서 표준 날짜/시간 API는 이러한 문제를 추상화하고, 안전하고 직관적인 인터페이스를 제공하여 개발 생산성을 높입니다.

---

## 주요 프로그래밍 언어의 날짜/시간 API

### 자바: `java.time` 패키지 (JSR-310)

자바 8부터 도입된 `java.time` 패키지는 기존의 `Date`와 `Calendar` 클래스의 문제점을 개선하기 위해 설계되었습니다. 주요 클래스는 다음과 같습니다:

- **`LocalDateTime`**: 날짜와 시간을 포함하지만 타임존 정보 없음 (예: 2025-04-05T10:30:00)
- **`ZonedDateTime`**: 타임존을 포함한 날짜/시간 (예: 2025-04-05T10:30:00+09:00[Asia/Seoul])
- **`Instant`**: 유닉스 타임스탬프(UTC 기준 초 단위)를 표현
- **`Duration`**, **`Period`**: 시간 간격을 표현 (Duration은 시간 단위, Period는 날짜 단위)

```java
import java.time.LocalDateTime;
import java.time.ZoneId;

LocalDateTime now = LocalDateTime.now();
ZonedDateTime seoulTime = now.atZone(ZoneId.of("Asia/Seoul"));
System.out.println(seoulTime);
```

### Python: `datetime` 모듈

Python의 `datetime` 모듈은 `date`, `time`, `datetime`, `timedelta`, `tzinfo` 등의 클래스를 제공합니다. `pytz` 또는 `zoneinfo` (Python 3.9+)를 사용하면 타임존을 다룰 수 있습니다.

```python
from datetime import datetime, timezone
import zoneinfo

now = datetime.now(timezone.utc)
seoul = now.astimezone(zoneinfo.ZoneInfo("Asia/Seoul"))
print(seoul)
```

### JavaScript: 기존 `Date` 객체와 `Temporal` 제안

JavaScript의 기존 `Date` 객체는 여러 설계 문제로 인해 비판받아 왔습니다 (예: 월 인덱스가 0부터 시작). 이를 개선하기 위해 **Temporal**이라는 새로운 날짜/시간 API가 제안되고 있으며, TC39 단계에서 진행 중입니다.

```js
// Temporal 제안 예시 (실험적 기능)
const now = Temporal.Now.plainDateTimeISO();
const withTimezone = now.toZonedDateTime({ timeZone: 'Asia/Seoul' });
console.log(withTimezone);
```

---

## 공통 설계 원칙

현대 날짜/시간 API는 다음과 같은 설계 철학을 공유합니다:

- **불변성**(Immutability): 객체가 생성된 후 변경되지 않으며, 연산은 새로운 객체를 반환
- **명확한 분리**: 날짜, 시간, 타임존, 지속 시간 등을 별도의 타입으로 분리
- **타임존 인식**: UTC, 로컬 시간, 특정 지역 시간을 명확히 구분
- **표준 포맷 지원**: ISO 8601 형식을 기본으로 사용

---

## 실용적 사용 패턴

- **현재 시간 얻기**: `LocalDateTime.now()` 또는 `ZonedDateTime.now()`
- **날짜 계산**: `plusDays(1)`, `minusHours(2)` 등 메서드 활용
- **포맷팅**: `DateTimeFormatter` (자바), `strftime()` (파이썬) 사용
- **파싱**: 문자열을 날짜 객체로 변환
- **타임존 변환**: UTC ↔ 로컬 시간 변환 시 DST 자동 처리

---

## 참고 자료 및 관련 문서

- [Java java.time 패키지 공식 문서](https://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html)
- [Python datetime 모듈 문서](https://docs.python.org/3/library/datetime.html)
- [Temporal Proposal for JavaScript (TC39)](https://tc39.es/proposal-temporal/)
- ISO 8601 표준: 국제적인 날짜/시간 표현 형식

---

날짜/시간 API는 단순한 유틸리티를 넘어서, 신뢰할 수 있는 시간 처리를 위한 핵심 인프라입니다. 표준 라이브러리로 제공되는 API를 올바르게 사용하면 버그를 줄이고 국제화된 애플리케이션을 보다 쉽게 개발할 수 있습니다.